home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / comm / nb32164.zip / NEWSBIN.TXT < prev   
Text File  |  1996-05-29  |  11KB  |  363 lines
  1.      NewsBin: Automated NNTP Downloader and Decoder for 95 and NT
  2.  
  3.     Ignore the register button, I haven't hooked it up yet sorry.
  4.  
  5.  
  6.     If you have any suggestions for improvements or bug reports - please
  7.     drop me a line at:
  8.  
  9.                     minor_c@mediasoft.net
  10.  
  11.  
  12.  
  13.  
  14. Introduction:
  15.  
  16.         Are you tired of having to manually download newsgroup binaries?
  17.     Well Newsbin is for you. Newsbin the unattended and automatic newsgroup
  18.     downloader and decoder short circuits the whole process by combining a
  19.     downloader, grouper and decoder into one package. Newsbin has many
  20.     features:
  21.  
  22.     - Shareware - test is as much as you want if you like it then
  23.         you pay the $10.00.
  24.  
  25.     - Tested on Win95 and Windows NT over SLIP and Ethernet
  26.  
  27.     - Unattended downloads - connect and let it download your groups
  28.     while you do something more interesting.
  29.  
  30.     - Isn't a resource hog. It is a good Windows multitasker meaning
  31.     that you can still use your machine for other things while the
  32.     downloads take place.
  33.  
  34.     - No temporary files are made on your machine. You just need enough
  35.     disk space for the binarys you download.
  36.  
  37.     - Groups news records together then automatically downloads and decodes
  38.  
  39.     - Keeps track of the last time it downloaded and won't download
  40.     records it has already seen.
  41.  
  42.     - Automatic and manual mode. Allows users on slow links to pick and
  43.     choose which files to download and allows user on high speed links
  44.     to download everything.
  45.  
  46.     - Allows you to download a complete list of newsgroups that your
  47.     server supplies.
  48.  
  49.     - Supports multiple servers - it will download from a list of
  50.     servers found in the INI file. When it finishes with one server, it
  51.     will go on to the next one in the list.
  52.  
  53.     - Supports up to 50 newsgroups (could easily be more if necessary)
  54.  
  55.     - Knows the SOCKS protocol, can get through firewalls even if your
  56.     protocol stack can't. Simply add the socks server to the INI file.
  57.     use the INI file that follows as a model.
  58.  
  59.     - You get all this in a program that is under 100K
  60.  
  61.  
  62. New for Rev 1.64 - Small enhancements and Bug Fixes.
  63.  
  64.     - Bar gauges that show current download status for every file.
  65.  
  66.     - Authenticated server support.
  67.  
  68.     - Better decoder.
  69.  
  70.     - Support for alternate ports.
  71.  
  72.     - Auto start and Auto stop now work right.
  73.  
  74.     - More robust menues.
  75.  
  76. New for Rev 1.63 - Small enhancements and Bug Fixes.
  77.  
  78.     - Save the current status of the download after every group - this
  79.       prevents crashes from screwing up all of the status saved up to the
  80.       point of the crash.
  81.  
  82.     - Support for Directory tree breakout, files can be downloaded to
  83.       directories that mirror the news group directories.
  84.  
  85.     - Modern UUEncoding replaces all spaces with ` symbols. I was
  86.       stripping spaces out, damaging files. No more.
  87.  
  88.     - still got the menu deletion bugs. Edit the INI file by hand for
  89.       best results at least until I get off my ass.
  90.  
  91. New for Rev 1.62
  92.  
  93.     - 1.62 is basically a bug fix. It fixes the more then 10 record
  94.       bug that was reported by several users.
  95.  
  96.     - It fixes the crash problem on Win95. Win95 has a serious bug in
  97.       the shutdown command. This command is used to perform a quick
  98.       shutdown of a socket. Under NT it works great, under 95 it often
  99.       blows up the kernel in the of the VXD's like VTDI or IFSMGR. I
  100.       blew it when I released 1.61 with this command enabled. I had been
  101.       experimenting with NT and forgot to remove it.
  102.  
  103.     - NewsBin still has those minor INI deletion bugs. Since I wanted
  104.       1.62 to be a fix for critical errors I chose to put off fixing
  105.       them until the next major release.
  106.  
  107.  
  108. New for Rev 1.61
  109.  
  110.     Rev 1.61 has been completely revamped. It now downloads on the fly
  111. using threads which are handed all the information they need to perform
  112. a download. While the download takes place, the header records are still
  113. downloaded. This mechanism was suggested by a user. It maximizes the use
  114. of modem bandwidth.
  115.  
  116.     - Files are downloaded as they are recognized instead of after all of the
  117.       headers are downloaded.
  118.  
  119.     - As many as 9 simultaneous files can be downloaded. Threads are selectable
  120.       from the front panel. I don't recommend using more then 4 or 5 threads
  121.       unless you have a special application.
  122.  
  123.     - Flushing of records is a thing of the past. When a thread
  124.       determines that a records isn't part of a file or that the file
  125.       already exists, it simply dumps the socket and the thread and
  126.       starts processing the next record. This greatly reduces the
  127.       bandwidth usage.
  128.  
  129.     - can be paused by setting the threads to zero. Once the current
  130.       downloads are complete the program will simply wait until you turn
  131.       the threads up again.
  132.  
  133.     - subject fields are cached in a file for a week. This reduces the
  134.       unwanted downloads that can occur if you delete a file in the
  135.       download directory but later re-download the header records for
  136.       it.
  137.  
  138.  
  139. Installation:
  140.  
  141.     Installation couldn't be simpler. Create a directory for Newsbin
  142.     then copy the ZIP file into the directory. pkunzip the file using
  143.     the command:
  144.  
  145.         pkunzip -d NB32163.ZIP
  146.  
  147.  
  148.     What this will do is place these three files into the subdirectory.
  149.  
  150.     1) newsbin.exe - the executable
  151.     2) newsbin.ini - the configurations file
  152.     3) newsbin.txt - this file
  153.  
  154.     It will create a subdirectory called "download" under the current
  155.     directory. The download directory is where the program places the
  156.     binaries that are downloaded from the Net.
  157.  
  158.     You now need to add Newsbin to one of your program groups.
  159.  
  160.     You need to edit the "newsbin.ini" file to customize it for your
  161.     installations. A sample INI file follows:
  162.  
  163.  
  164. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  165. ; Socks server - lets you get through a firewall of it is equiped with
  166. ; a socks daemon - socks requires a server to connect to and a
  167. ; userid may also be needed
  168. ; Uncomment by removing the semi-colons
  169. ;
  170. ; Uncomment to activate
  171. ;
  172. [SOCKSSERVER]
  173. ;SOCKS=SOCKS
  174. ; This is optional for most socks installations. but, don't leave it
  175. ; blank
  176. ;USERID=YOURUSERID
  177. ;PASSWD=YOURSOCKSPASSWD
  178.  
  179. ;
  180. ; List of servers to connect to - you must fill in your own server
  181. ;
  182. [SERVERS]
  183. server0=news
  184.  
  185. ;
  186. ; The news groups that you wish to check for binary files
  187. ; Notice the group and group numbers. The numbers must start
  188. ; at zero and be contiguous.
  189. ;
  190. ; The first number to the right is the last record that has been
  191. ; received from the news server. They are used to prevent the
  192. ; download of records that have already been received
  193. ; Zero it out if you wish to redownload the entire group
  194. ;
  195. ; The second number is either 1 or 0
  196. ;   1 means the group is active
  197. ;   0 means the gorup in inactive
  198. ;
  199. [GROUPS]
  200. group0=alt.binaries.sounds.mod 100 1
  201. group1=alt.binaries.warez.ibmpc 100 0
  202.  
  203. ;
  204. ; These are changed from the front panel of NEWSBIN. Either in the setup menu
  205. ; or from the front panel buttons
  206. ; it is unneccessary to change them here. Of course you can if you wish
  207. ; 1 means active
  208. ; 0 mean  inactive
  209. ;
  210. [MODE]
  211. ; Download automatically or not
  212. AUTO=1
  213.  
  214. ;Download List of all groups or not
  215. GROUP=0
  216.  
  217. ;Detail High Detail or not
  218. DETAIL=1
  219.  
  220. ; Autostart mode - start without requiring a click on the start menu
  221. AUTOSTART=0
  222.  
  223. ; Download Path
  224. DOWNLOADPATH=.\DOWNLOAD
  225.  
  226. ; UPLOAD Path
  227. UPLOADPATH=.\UPLOAD
  228.  
  229. ; Filename for the groups listing file
  230. GROUPFILENAME=groups.txt
  231.  
  232. ;
  233. ;
  234. ; Uploading will be activated later - depending upon demand of course
  235. ; and only for registered users.
  236. ;
  237. [UPLOAD]
  238. ; Who to post this stuff to
  239. POSTAGENT=news1
  240.  
  241. ; Maximum size in bytes  of records to post
  242. ; Some systems are limited to 64K
  243. FRAGSIZE=32000
  244.  
  245. ; Not Used yet but required duh!
  246. LINES=1100
  247.  
  248. ; Groups to Post to
  249. GROUPS=alt.binaries.pictures.erotica,alt.sex.pictures
  250.  
  251. ;
  252. ; These are changable on the non-shareware version
  253. ; of this software
  254. ;
  255. PATH=dufus@newsbin.com
  256. SUBJECT=NewsBin Auto Poster
  257. AGENT=NewsBin News Robot by CNM - minorc@mediasoft.net  Unregistered Shareware
  258. AUTHOR=RegisterNewsBin@10dollars.com
  259. ORGANIZATION=NewsBin
  260. NNTPPOSTINGHOST=dufus@newsbin.com
  261. NEWSREADER=NewsBin Ro